Well Test > Configuring CygNet Well Test > Configuring Well Test Using XML > Elements and Attributes > Wells, Well

Wells, Well

The <Wells> element of the XML configuration contains a list of <Well>s associated with each header. Each well is associated with a facility tag and position number. Only enabled wells will be tested. Two attributes, enabled and enabledUdc, are used to determine if the well is active and should be tested.

To learn about how these elements relate to other elements in a well test configuration XML structure, see Well Test Hierarchy.

Example

<Headers>

<Header tag="MYSITE.UIS::BUTCHER_TESTSEP" enabled="True" template="MbSim">

<Wells>

<Well tag="MYSITE.UIS::AMANDA_WL" position="1" enabled="True" enabledUdc="ENABLED"/>

<Well tag="MYSITE.UIS::ESSEN_WL" position="2" enabled="True" enabledUdc="ENABLED"/>

<Well tag="MYSITE.UIS::PELICAN_WL" position="3" enabled="True" enabledUdc="ENABLED"/>

<Well tag="MYSITE.UIS::VIRGINIA_WL" position="4" enabled="True" enabledUdc="ENABLED"/>

</Wells>

</Header>

<Header tag="MYSITE.UIS::CALVIN_TESTSEP" enabled="True" template="ModbusCustom">

<Wells>

<Well tag="MYSITE.UIS::ELLIOT_WL" position="1" enabled="True" enabledUdc="ENABLED"/>

<Well tag="MYSITE.UIS::JOHNSON_WL" position="2" enabled="True" enabledUdc="ENABLED"/>

<Well tag="MYSITE.UIS::POOLE_WL" position="3" enabled="True" enabledUdc="ENABLED"/>

</Wells>

</Header>

</Headers>

Wells

The <Wells> element has one type of child element, <Well>, and has no attributes.

Well

Well Properties

The <Well> element has the following properties:

Property Description

Case Sensitive

Yes

Required

Yes

Number of Instances Allowed

Unlimited

Parent Element

<Wells>

Child Elements

None

Attributes

enabled

enabledUdc

position

tag

Well Attributes

Each <Well> element has the following attributes:

Attribute Required Description

enabled

Yes

Specifies whether the well can be tested. While it is possible for the header queue to contain wells that are disabled, only enabled wells will be tested. When a well is read from the top of the header queue, prior to testing, the enabled attribute will be read.

  • If the well is enabled (True), the associated well command and actions will be processed
  • If the well is not enabled (False), the well will not be tested and the next well in the queue will be evaluated

Note: Make sure you read the definition for the enabledUdc attribute for further usage notes on the enabled attribute.

Options include True or False.

enabledUdc

No

The Enabled UDC property (enabledUdc) allows the configuration of the Enabled (enabled) property by point. The defined UDC will be combined with the facility tag to formulate a point. The Enabled UDC Property /enabledUdc attribute takes precedence over the Enabled (enabled). Click the browse button to open the Select UDC dialog box and select an appropriate UDC.

  • If that point exists and has a valid value (either True or False), then that value is used to determine the enabled status.
  • If the point doesn’t exist or the value is invalid, then the enabled attribute value will be used. If in this case, the enabled attribute is not configured, and it will be assumed that the well is not enabled.

Note: This attribute allows manipulation of a well's enabled/disabled status external to the Canvas Well Test Status screen, and the CygNet Well Test Module.

position

Yes

Specifies the position number for the well. This must line up with one of the positions in the associated header template. Values include 1, 2, 3, …, n.

tag

Yes

Specifies the fully qualified facility tag of the well in the format: site.service::facility_id. E.g., MYSITE.UIS::AMANDA_WL.
Back to top

Let us know how we can improve this topic.

CygNet at weatherford.com

© 2020 Weatherford. All rights reserved.